RIDGE ASSEMBLER REFERENCE MANUAL 
(RASM) 
August 30,1982 



The Ridge assembler (RASM) accepts source lines of Ridge instructions, 
pseudo instructions and assembler directives, and produces either 
executable object code or object code suitable for input by the 
.linker. Following is a list of rules for the assembler source syntax. 

Syntax Notation 

Register numbers are indicated by (Rl) or (R2) . Registers are 
specified by Rn where "n" can be 0 - 15. Usage of "R2" indicates a 
literal value from 0 -15, rather than the register number. Items 
enclosed by braces, "{", and indicate one token must be selected. 
Items enclosed by brackets, "["r and are optional. 



1. Source line input is free-form, with the restriction that the 
first character of a line is reserved for labels. Labels are either 
jump targets, pseudo instructions or assembler directives. 
Instructions may begin following a jump target label, or after one or 
more leading blanks on a line. 

2. Jump targets must be followed by a 

3. Blank lines are ignored. 

4. Input following a ";" is ignored. 

5 Expressions used may contain decimal numbers, hex numbers or label 
names. "+", "-"r "*% V"f and "(...)" may be used in expressions. 

6. Hex numbers must begin with the digits 0 - 9 and must end with 



7. Labels must start with A - Z and may contain digits 0-9. Labels 
may be an arbitrary length, but only the first 16 characters are used 
to uniquely identify a label. 

8. The assembler accepts both upper and lower case input, but does 
not distinguish between tokens that are of different case. 
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fi^QRPmhler Directives 

The assembler directives are listed below (all directives must 
as the first character on a line) : 



LIST 



Assembler displays each source line as it 
is read. This is the assembler default. 



NOLIST 



Assembler does not print source lines. 
Errors are still displayed, however. 



HEXOUT 



Assembler output is an object file suitable 
for linking. EXTERNAL and GLOBAL names 
are placed in the output file. 



ALIGN {2} 
{4} 
{8} 



The next instruction assembled is placed 
on a 2, 4, or 8-byte boundary r as 
specified. 



PAGE 



Places a form feed in the output file. 
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Paeudo Instructions 



label CODE expression 

This equates a label with an expression 
that can be used in instructions that 
reference the code segment, "label" 
must be the first character of a line. 



expression 

This equates a label with an expression 
that can be used in instructions that 
reference the data segment, "label" 
must be the first character of a line. 

The next instruction assembled is placed 
at byte "n" in the object code. The 
assembler default places the first 
instruction assembled in the first byte 
of the object file. 

BLOCK count, byte "byte" is an expression that is placed in 

the object code. "count" is a replication 
factor that must be a positive integer. 

EXTERNAL name This places the label "name" in the 

HEXOUT object file. All references 
to "name" can be resolved by the linker 
program. EXTERNAL must be used in the 
source text before any occurrences of 
"name" . 



label DATA 



ORIGIN n 



GLOBAL name This places the label "name" in the 

HEXOUT object file. This permits labels 
used in the assembled code module to be 
bound by the linker to EXTERNAL references 
in other code modules. 
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Tnsf ruction Svntax 

The syntax for Ridge instructions is listed below. 



7.ero Reqjster Format Instru ctions 

{FLUSH } 
{TRAPEXIT} 
{RUM } 



QnP Registe r ForiTlt^t Instructions 
{ELOGR} 

{ELOGW} (Rl) 
{ITEST} 
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Two Register Format Ins tructions 



instr (Rl) r (R2) 

Where "instr" is one of the following (as they appear in the opcode 
chart) ! 



NEG 


SUS 


ADD 


LUS 


SUB 


LDREGS 


Mpy 


TRANS 


DIV 


DIRT 


REM 


READ 


NOT 


WRITE 


OR 




XOR 


CALLR 


AND 


RET 


CBIT 




TEXT 


LSL 


SB IT 


LSR 


CHK 


ASL 




ASR 


NOP 


DLSL 




DLSR 


FIXT 


CSL 


FIXR 




RNEG 




RADD 




RSUB 




RMPy 




RDIV 




MAKERD 




LCOMP 




FLOAT 




RCOMP 




EADD 




ESUB 




EMPy 




EDIV 




DFIXT 




DFIXR 




DRNEG 




DRADD 




DRSUB 




DRMPy 




DRDIV 




MAKEDR 




DCOMP 




DFLOAT 




DRCOMP 
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Pp^riai RPoiRl-er Formats 



MOVE 



KCALL 



TRAP 



{ (Rl) r (R2) } 
{ (SRI) , (R2) } 
{ (Rl) r (SR2) } 



n 



n 



where "n" is an expression that results 
in an integer from 0 -255 



where "n" is an expression that results 
in an integer from 0-15 



TEST 



iPrL Format 

(Rl) lop { (R2) } 
{ R2 } 



where lop is : >f <, =r <=r 



pr^i^pf-h Format 

Unconditional branch: 

BR target [,L] 
target is an expression 



where L indicates long (32-bit) 
displacement 



Call: 



CALL (Rl) r target [,h] 



where L indicates long (32-bit) 
displacement 



target is an expression 
Conditional branches: 

{IBop} (^1' ( \ ' target [1 I'^-l 

where 

lop is one of: <, =f <=r >-f <> 

4- (no space following target name) set branch 
^^^gf idiction bit in target displacement 

L indicates long (32-bit) displacement 
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Memory Reference Format 



{LOADB 
{LOADH 
{LOADHS 
{LOAD 
{LOADD , 
{LADDR } (Rl) { r (R2) [f 
{ } {[f (R2)] 

{STOREB 
{STOREH 
{STORE 
{STORED. 
{ 

{LOADBP 
{LOADHP 
{ LOADH SP 
{LOADP 
{LOADDP 
{LADDRP 



address 
address 



[r 



L] 



]} 
]} 



where 



"address" is an expression 

L indicates long (32-bit displacement) 

Load instructions followed by "P" reference the code 
segment; those without reference the data segment. 
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